home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d13 / paus12.arc / PAUS.DOC < prev    next >
Text File  |  1991-03-10  |  5KB  |  152 lines
  1.  
  2.  
  3.                               Paus.Com
  4.  
  5.                              Version 1.2
  6.                            March 9th, 1991
  7.               Copyright 1989 and 1991 by Jeffrey S. Morley
  8.                         All rights are reserved
  9.  
  10.  
  11.  
  12. Paus.Com is a full-featured timed PAUSE/ASK program that offers the following:
  13.  
  14. *  Prompt with any text you desire
  15. *  Position the text prompt anywhere on the screen
  16. *  Use any foreground and background color combination,
  17.         including high-intensity background colors.
  18. *  Timed execution, with automatic fall through after specified
  19.         number of seconds.
  20. *  ERRORLEVL returned to DOS based on keys pressed by user (or lack
  21.         thereof...)
  22. *  Silent execution, or clock ticks as timer counts down.
  23.  
  24.  
  25. SYNTAX:
  26.  
  27. PAUS [/Rxx] [/Cxx] [/Fxx] [/B:xx] [/Nx] [/Dxx] [/Tmessage]
  28.  
  29. Where:
  30. R = Row Position of 1 TO 25
  31. C = Column Position of 1 TO 80
  32. F = Foreground Color of 0 TO 15
  33. B = Background Color of 0 TO 15
  34. N = Clock Ticks  0=off OR 1=on
  35. D = Duration of 1 TO 9999 Seconds
  36. T = Your text message
  37.  
  38. All the parameters are optional, PAUS by itself will timeout in 30 seconds.
  39.  
  40. PAUSE /? or PAUSE /HELP will call up a help screen.
  41.  
  42. SAMPLE:
  43.  
  44. C:>PAUS /R12 /C22 /F4 /B15 /N1 /D10 /THit any key...
  45.  
  46. This sample will place the text "Hit any key..." on row 12 starting at 
  47. column 22.  The prompt will be in red with a bright white background.
  48. Paus.Com will count down for 10 seconds before exiting.
  49.  
  50. Hitting any key will exit Paus before the end of DURation, exiting with a
  51. DOS errorlevel based on the key pressed.
  52.  
  53. Key pressed = Y(y)    ERRORLEVEL = 89
  54. Key pressed = N(n)    ERRORLEVEL = 78
  55. Any other key         ERRORLEVEL = 1
  56. No key pressed        ERRORLEVEL = 0
  57.  
  58.  
  59. SCREEN COLORS:
  60.  
  61. The colors for the numbers 0 to 15 are:
  62.  
  63.         0               BLACK
  64.         1               BLUE
  65.         2               GREEN
  66.         3               CYAN
  67.         4               RED
  68.         5               MAGENTA
  69.         6               BROWN
  70.         7               WHITE (GREY)
  71.         8               HIGH BLACK
  72.         9               HIGH BLUE
  73.         10              HIGH GREEN
  74.         11              HIGH CYAN
  75.         12              HIGH RED
  76.         13              HIGH MAGENTA
  77.         14              HIGH BROWN (YELLOW)
  78.         15              HIGH WHITE
  79.  
  80. If you use a high intensity BACKGROUND color, it will set all text currently 
  81. on the screen to use high intensity backgrounds in place of blinking text. 
  82. When it returns to normal blinking mode at the end of the program, things 
  83. that had high intensity backgrounds will begin to blink. for this reason, 
  84. Paus.Com will always clear the screen before and after execution if high 
  85. intensity backgrounds are used.  Otherwise, the screen will not be cleared.
  86.  
  87.  
  88. BATCH FILE CONSIDERATIONS:
  89.  
  90. Please don't forget that DOS examines the ERRORLEVL in what may seem to
  91. be reverse order.  In other words if you have an ERRORLEVL of 89, and you
  92. test with "IF ERRORLEVEL 1", the result will be TRUE.  DOS considers an
  93. ERRORLEVEL set if the current ERRORLEVEL is equal to OR GREATER THAN the
  94. tested level.  With this in mind, be sure to test in order of largest to
  95. smallest.
  96.  
  97.  
  98. SAMPLE BATCH FILE: (see TEST.BAT in ZIP'ive)
  99.  
  100. @ECHO OFF
  101. PAUS /N1 /D10 /TIs Jeffrey Morley a swell guy?
  102. IF ERRORLEVEL 89 GOTO GotYes
  103. IF ERRORLEVEL 78 GOTO GotNo
  104. IF ERRORLEVEL 1 GOTO GotOtherKey
  105.  
  106. ECHO.
  107. ECHO The ERRORLEVEL is 0, Need more time to find "Y"?
  108. GOTO END
  109.  
  110. :GotYes
  111. ECHO.
  112. ECHO You answered yes!  A fine judge of character...
  113. GOTO END
  114.  
  115. :GotNo
  116. ECHO.
  117. ECHO You answered no?  Well same to ya...
  118. GOTO END
  119.  
  120. :GotOtherKey
  121. ECHO.
  122. ECHO Not really sure eh... "Y" is right between "T" and "U"!
  123.  
  124. :END
  125.  
  126.  
  127. PROGRAM INFO:
  128.  
  129. Paus.Com is copyrighted by Jeffrey S. Morley, and all rights are reserved.
  130. It is being distributed as FREEWARE, which means that you may use and
  131. distribute the program without renumeration to the author.  It is asked
  132. that you distribute the program and all documentation in its original
  133. condition.
  134.  
  135. Paus.Com was written in MicroSoft QuickBasic version 4.5, with help from
  136. Hammerly Computing Services' PROBAS 4.0 library of QuickBasic routines.
  137.  
  138. *******************************************************************************
  139. Version 1.2  March 9, 1991
  140. *******************************************************************************
  141. Version 1.2 is a re-write to improve the command line structure.  The
  142. older method of DUR:1 as opposed to /D1 was not very standard.  Microsoft
  143. wants us all to use / for the parameter switch character, and /? as a call
  144. to help.  I'm on board Bill!
  145.  
  146. The program will also now pad a space in front and in back of the text it
  147. displays, making it look better when you have a background color set.
  148.  
  149. Please note!  You will need to change any existing batch files which use 
  150. the older command line structure.
  151.  
  152.